Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: QuickDraw GX Objects /
Chapter 4 - Colors and Color-Related Objects / Colors and Color-Related Objects Reference
Color Profile Functions / Retrieving and Replacing Profile Information


GXLockColorProfile

You can use the GXLockColorProfile function to load a color profile object into memory and lock its profile data into a fixed memory location.

void GXLockColorProfile (gxColorProfile source);
source
A reference to the color profile to be loaded and locked.
DESCRIPTION
The GXLockColorProfile function prevents a color profile from being relocated, so that you can manipulate its profile data directly in QuickDraw GX memory rather than working with a copy of it in application memory.

To directly edit the color profile, call GXLockColorProfile followed by GXGetColorProfileStructure; after editing, call GXUnlockColorProfile.

SPECIAL CONSIDERATIONS
To avoid fragmenting the QuickDraw GX heap, call the GXUnlockColorProfile function as soon as possible after calling GXLockColorProfile.

In low memory situations with a fragmented heap, QuickDraw GX can unlock locked objects without warning. Be careful about making memory-intensive calls when you are working with a locked color profile.

ERRORS, WARNINGS, AND NOTICES
Errors 
out_of_memory 
colorProfile_is_nil 
SEE ALSO
The GXUnlockColorProfile and GXGetColorProfileStructure functions are described in the next two sections.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996




Navigation graphic, see text links

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help